home *** CD-ROM | disk | FTP | other *** search
/ Aminet 8 / Aminet 8 (1995)(GTI - Schatztruhe)[!][Oct 1995].iso / Aminet / misc / unix / mapux.lha / MAPUX.readme < prev    next >
Text File  |  1992-09-02  |  6KB  |  135 lines
  1. This is a quick pre-release binary-only demo of MAPUX, a UNIX-a-like for
  2. Amigas without MMUs.  This distribution has been compiled on and for an
  3. Amiga A1200 with just the usual 2MB of RAM.  Currently the only devices
  4. are /dev/fdd (the single internal floppy), /dev/tty[0123] (four separate
  5. "terminals" using the Amiga's internal video, /dev/null and /dev/mem.  A
  6. hard disc, or a great deal of patience, is required to actually boot MAPUX.
  7.  
  8. MAPUX may work on other Amigas: they must have a contiguous area of memory
  9. from 0 to 2MB (doesn't need to be ChipRAM) and have at least an '020 because
  10. of some m/c instructions used.  Higher processors may also work (untested)
  11. and machines with less memory may work for a limited period (the system
  12. uses low memory address first).
  13.  
  14. The MAPUX kernel is a port and enhancement of UZI, a freely distributably
  15. V7 kernel for Z80 systems, written from scratch by Douglas Braun.  Please
  16. direct all reponses to me, not him, as he is not liable in any way shape or
  17. for MAPUX's bugs, shortfalls or whatever.
  18.  
  19. You will need Bruno Costa's dd (available from Aminet as /disk/misc/dd.lzh)
  20. in order to alter the contents of the floppy disc.  The file included with
  21. this distribution called 'testdev' is an image of the contents of a standard
  22. format floppy disc.  This image can be mapipulated by the supplied tools
  23. mkfs and ucp, which create a new filesystem and allow files to be read
  24. and written respectively.  The initial contents of testdev is probably the
  25. best place to start, however.
  26.  
  27. ucp, when run gives you a cross between an ftp session and a UNIX shell.
  28. get moves files from the AmigaDOS fs to the MAPUX one while put does the
  29. opposite.  mkdir, rmdir, mknod, chmod and so forth do what you'd expect.
  30.  
  31. fsck requires three arguments: device number (0), isize (block devoted to 
  32. inode storage) and fsize (total size of device in blocks).  An isize of
  33. 128 seems to work for me.  Device must be 0, and fsize must be 1760.
  34.  
  35.  
  36. In order to boot MAPUX:
  37.     - dump the floppy image to the drive using the supplied scriptette
  38.     'dwrite'.
  39.     - reset your 1200 and boot with no startup sequence
  40.     - cd into wherever you unpacked the archive
  41.     - execute the command mapgo
  42. If all goes well, the file kerim will be loaded into low memory and
  43. executed.  You will be presented with a short message and a prompt (boot:)
  44. enter 0 (device number of the floppy drive) and press return.  You should
  45. then notice some disc activity then a login: prompt.  MAPUX is running.
  46.  
  47. There are three users already set up: root, mcy and tester.  All three have
  48. the same password as login (in this binary the password is displayed - I
  49. don't know why, it didn't before, I'll add it to the bug list).
  50.  
  51. /bin contains some commands written by myself.  They are not complete
  52. implementations of the UNIX version and none of them accept any flags.  When
  53. a suitable C library becomes available the BSD commands (or others) may be
  54. used instead.
  55.  
  56. Used the function keys f1, f2, f3, and f4 to move between the terminals.
  57. Beware that the multiple terminals were not supported in UZI and in MAPUX
  58. still, a control-C will send to signal to _all_processes_you_own_ not just
  59. those started from the current terminal.  This is on the to-fix list.
  60.  
  61. The shell, winsh, is the Well I Never SHell.  It's small and largely
  62. featureless.  It supports IO redirection (>,<, and >>) but not pipes (this
  63. is a limitation of winsh, not MAPUX).  Variables can be set with "set vname
  64. value" and accessed in commands by prefixing vname with a dollar symbol.  
  65. Some variable names are already set by login.  Try these:
  66. echo $name
  67. echo $realname
  68. echo $home
  69. echo $path
  70. The $path variable is used by the shell when looking for commands.
  71. Previous commands can be executed with "!-n" where n is 1-7.  Use the
  72. command "history" to see what's in the buffer.  logout exits from the shell
  73. (without sending SIGHUP to running processes - something else for the fix
  74. list).
  75.  
  76. Most commands that use filenames also accept wildcards in a twisted kind of
  77. way (not regexps, just * and ?).  Also they generally accept several
  78. filenames on the command line.  ls in particular does not behave as you
  79. might expect (try 'ls /bin' then 'ls /bin/*').  The supplied commands are:
  80.  
  81. cat filename        Dump files to stdout
  82. chmod perms file    Change file permissions (argument in octal)
  83. chown uid gid file    Change owner and group of file (uid/gid as numbers)
  84. clear            Clear the screen
  85. cmp file file        Compare two files (result is retval, not displayed)
  86. echo words        Print arguments of stdout
  87. kill -signum pid    Send a signal to a process
  88. ls file            Lists the contents of directories
  89. mkdir file        Creates a new directory (buggy)
  90. mknod perms dev file    Creates a node in the filesystem (buggy)
  91. winsh            The rather dodgy shell
  92. sleep n            Waits for n seconds
  93. sync            Flushes the buffers (do this before powerdown)
  94. emit a b c...        Echos decimal ASCII values to stdout
  95. init            The first process run automatically by MAPUX
  96. login            Allows one to log into the machine
  97. dump file        Hexadecimal/ASCII dump of a file
  98. error n            Turns an error number into an English message
  99. ps            Lists running processes
  100. rm            Removes a file (buggy when removing directorys)
  101. tetris            Slow tetris (think of it as a demo)
  102.  
  103. Other files in the supplied filesystem are:
  104. /etc/logins        List of devices when login prompts are displayed
  105. /etc/passwd        The password file in the usual format.  Note that
  106.             currently there is no password encryption
  107.  
  108. /dev/fdd        The floppy disc block device
  109. /dev/tty        Console device (press f1)
  110. /dev/null        The null device
  111. /dev/mem        All memory as a character device (used by ps)
  112. /dev/tty[123]        The other terminals (press f1,f2,f3)
  113.  
  114.  
  115. There are some known bugs in the commands and in the kernel itself.  If you
  116. find any, please let me know.  If you can narrow them down to a particular
  117. circumstance, that's even better (rather than "Sometime when I...").
  118. Parts of the code are copyright other people but freely disributable.  I
  119. trust they won't sue for lack of acknowldegment in this release.  Everything
  120. will be included in the forth coming source release.
  121.  
  122. If you want a copy of the source now, send a blank floppy and SSAE to me
  123. and I'll return said code (as it currently stands) to you.  I'll upload 
  124. it when I've fixed a few of the more pressing bugs.  Note that the most
  125. urgent things needed now are harddrive drivers and a native C compiler.
  126. If you could help with either of these, please drop me a line.  Thanks.
  127.  
  128. My snail address is:
  129. Martin Young,
  130. 74A Leigh Road,
  131. Eastleigh,
  132. Hants.
  133.  
  134.  
  135.